Title Banner

Previous Book Contents Book Index Next

Inside Macintosh: QuickTime Components /
Chapter 2 - Movie Controller Components / Movie Controller Components Reference
Movie Controller Functions / Managing Controller Attributes


MCGetControllerBoundsRgn

Some movie controllers may not be rectangular in shape. The MCGetControllerBoundsRgn function returns the actual region occupied by the controller and its movie, if the movie is attached to the controller. If the movie is not attached to its controller, the boundary region encloses only the control portion of the controller. The rectangle returned by the MCGetControllerBoundsRect function (described in the previous section) bounds the region returned by MCGetControllerBoundsRgn.

pascal RgnHandle MCGetControllerBoundsRgn (MovieController mc);
mc
Specifies the movie controller for the operation. You obtain this
identifier from the Component Manager's OpenComponent or OpenDefaultComponent function, or from the NewMovieController function.
DESCRIPTION
As with the MCGetControllerBoundsRect function, the MCGetControllerBoundsRgn function returns a region that reflects the size, shape, and location of the controller, even if the controller is hidden. Your application must dispose of the returned region.

The MCGetControllerBoundsRgn function returns a handle to the boundary region. Your application must dispose of this region.

RESULT CODES
Memory Manager errors

SEE ALSO
You can use the MCGetWindowRgn function, described in the next section, to determine the portion of the window that is currently in use by the controller.


Previous Book Contents Book Index Next

© Apple Computer, Inc.
7 JUL 1996




Navigation graphic, see text links

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help